home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Games / PC-SIG World of Games (CDRM1080710) (1993).iso / UPDATES / DISK3403.ZIP / KEY10.EXE / KEY.DOC < prev   
Text File  |  1992-02-07  |  15KB  |  335 lines

  1.  
  2.                       ╔══════════════════════╗
  3.                       ║  Welcome to KeyStuff ║
  4.                       ║   Ver 1.0  12/20/91  ║
  5.                       ║   (c) 1991 RSE Inc.  ║
  6.                       ╚══════════════════════╝
  7.  
  8. Several users of my "Playback" program have asked if I'd write a program 
  9. that would take an ASCII file and stuff it into the keyboard.  Most of 
  10. these requests came from people who wanted to take data generated by one 
  11. program and enter it into another without having to type the data in.  
  12.  
  13. Basically KeyStuff does exactly that.  It takes an ASCII file and feeds 
  14. it into the keystroke buffer as fast as the buffer will take it.  
  15. However, I've added other features that make KeyStuff much more powerful.  
  16. For example, you can insert special characters into the file that will 
  17. cause KeyStuff to wait a certain period of time before continuing.  You 
  18. can also include special keys in your data files like the function keys, 
  19. cursor keys, backspace, insert, and many more.  In addition you can tell 
  20. KeyStuff to initiate the stuffing immediately, when a hot key is pressed, 
  21. or even unattended at some later time.  The result is a program that can 
  22. automate most any task and execute it unattended at any time.  You can 
  23. create files that backup your hard disk at 3 am, or get your E-Mail 
  24. automatically and have it waiting for you when you show up for work.  The 
  25. uses are endless.  For example you could create a file that would gather 
  26. data from several remote sites via your modem and then enter that data 
  27. into your database or spreadsheet program, or printer, automatically. 
  28.  
  29. How does "KeyStuff" differ from "Playback"?  Although the end results can 
  30. be similar, Playback operates on a completely different principle.  
  31. Playback works like a tape recorder.  You turn it on, complete the task 
  32. you want to automate, and then turn it off.  Your keystrokes are recorded 
  33. as well as the delay between keystrokes so that when you replay them they 
  34. do exactly what you were doing when you first recorded them.  You can 
  35. turn the key sequences into .COM files which can be run from the DOS 
  36. prompt or from within batch files.  You can replay the key sequences via 
  37. a hot key, or unattended at some later time.  You can also adjust the 
  38. playback speed, edit the keyfiles, rename them, and much more.  In 
  39. addition, Playback's method of stuffing keystrokes is more sophisticated 
  40. than KeyStuff's and may work in situations where KeyStuff won't.   
  41. Playback excels at task automation. 
  42.   
  43. If you'd like to try Playback, look for it on your local BBS under the 
  44. name PB??.EXE where ?? is the version number.  If you can't find it 
  45. there, we will send you the unregistered version (along with our other 11 
  46. shareware programs) for $5.  Add $1 for 3.5 disk, $5 for overseas.   Send 
  47. check or money order (in US funds) to:  
  48.  
  49. RSE Variety Pac
  50. 1157 57th Drive SE
  51. Auburn, WA 98002
  52.  
  53. We have another keyboard stuffing program, of sorts.  It's called 
  54. "Nabbit" and it grabs characters off your screen and lets you send them 
  55. to your printer (to print addresses on envelopes, etc.) OR store the 
  56. characters in a buffer and later re-insert them through the keyboard.  
  57. This lets you grab information off the screen from one program, and then 
  58. reinsert it later into another program.  Nabbit goes by the file name 
  59. NAB??.EXE where ?? is the version number.  If you can't find it on your 
  60. BBS, the unregistered version comes on the Variety Pac mentioned above. 
  61.  
  62. == How Much? ==
  63.  
  64. KeyStuff is shareware.  As such you are given the program without 
  65. obligation in order to evaluate it.  If after a 3 week evaluation you 
  66. decide to continue using it then you are obligated to become a registered 
  67. user.  You register by sending $19+ $1 shipping (add $1 for 3.5 disk, $5 
  68. for overseas orders) to: 
  69.  
  70.         RSE KeyStuff              |      Visa or Mastercard
  71.         1157 57th Drive SE        |      Call or FAX (206) 939-4105
  72.         Auburn, WA 98002          |      Compuserve: 72371,1557
  73.  
  74. As a registered user you'll get the following additional benefits: 
  75.  
  76.         1. Technical support and the latest version of KeyStuff.
  77.  
  78.         2. The unregistered versions of our other shareware programs 
  79.            including Playback, Nabbit, FileNotes, Remind Me!, Trash-It, 
  80.            BriteLine, and others. 
  81.  
  82.         3. No more "please register" messages.
  83.  
  84. Because KeyStuff is shareware you are encouraged to give copies of it to 
  85. others as long as you don't modify the program or these instructions 
  86. and you don't charge for the copies.  The only exception to the last rule 
  87. is for shareware vendors who may charge a reasonable distribution fee. 
  88.  
  89. == Getting started ==
  90.  
  91. * Put KEY.COM in one of the subdirectories listed in the PATH statement in 
  92.   your AUTOEXEC.BAT file.
  93.  
  94. To begin stuffing a file into the keyboard:
  95.  
  96. * Move to the subdirectory where the data file is located
  97. * enter "KEY filename" where "filename" is the name of the data file you 
  98.   want to stuff into the keyboard.  
  99.  
  100. For example to start feeding the data file "STOCK.DAT" into the keyboard 
  101. buffer you would enter "key stock.dat" at the DOS prompt.
  102.  
  103. You MUST move to the subdirectory where the data file is located when you 
  104. enter the "KEY ..." command.  DO NOT specify the full pathname of the 
  105. data file.
  106.  
  107. == Aborting the stuffing of data ==
  108.  
  109. You can abort the keyboard stuffing at any time by pressing the Left 
  110. Shift key and the Right Shift key at the same time.  In other words, 
  111. press both shift keys at the same time to abort the keyboard stuffing.
  112.  
  113. == Hot key activated stuffing ==
  114.  
  115. There may be times when you don't want the stuffing to begin immediately 
  116. but would like it to start when you press a hot key.  You can do this by 
  117. adding the "/h" command line option when you start the program.  For 
  118. example, entering "key store.dat /h" tells KeyStuff not to begin 
  119. stuffing the STORE.DAT file until you press the hot key.  The hot key is: 
  120. Ctrl-LShift-RShift.  In other words, if you use the "/h" (h for "h"ot key 
  121. activation) command line option you initiate the stuffing by pressing the 
  122. Ctrl key and both shift keys all at the same time. 
  123.  
  124. == Time activated stuffing ==
  125.  
  126. If you'd like the stuffing to begin automatically at some later time you 
  127. use the command line option "/####" where #### is a four digit number 
  128. designating the time you want the stuffing to begin.  The #### must be in 
  129. 24 hour military time (3am = 0300, 11:30pm = 2330) and MUST be 4 digits 
  130. long.  For example, entering "key getmail /0200" would cause the "GETMAIL" 
  131. file to begin stuffing automatically at 2am.
  132.  
  133. == Inserting delays into your data files ==
  134.  
  135. Inserting delays into the stuffing of your data files can add power and 
  136. flexibility to your files.  You can use delays to wait for programs to 
  137. load, digest the data you just gave them, wait for modems to dial and 
  138. connect, etc.. 
  139.  
  140. You insert a delay into the stuffing of the data file by using a special 
  141. notation.  Edit the data file by going to the place where you want a delay:
  142.  
  143. * Hold down the Alt key 
  144. * Type in 222 on the numeric keypad
  145. * Release the Alt key
  146. * Enter the delay time in seconds
  147. * Follow the entry with a space
  148.  
  149. Consider the following: 
  150.  
  151. Scott▐1.5 Chaney
  152.  
  153. KeyStuff would stuff "Scott" into the keyboard, wait 1.5 seconds, and 
  154. then enter "Chaney".  ▐ is the character that appears when you hold the 
  155. Alt key down while entering 222 on the numeric keypad. 
  156.  
  157. == Delays at every carriage return ==
  158.  
  159. KeyStuff can also automatically pause after every carriage return.  This 
  160. allows the program into which you are stuffing data to digest the data 
  161. just entered before going on to the next item. 
  162.  
  163. You signal the delay value when you start KeyStuff by using the "/c#" 
  164. command line option, where # represents the delay in seconds (1.2, .5, 3, 
  165. etc.).  For example, entering "key customer.dat /c1.5" would cause 
  166. KeyStuff to begin stuffing the CUSTOMER.DAT file while pausing for 1.5 
  167. seconds after every carriage return.  You may use this option and still 
  168. place special delay characters within your data file. 
  169.  
  170. == Getting input from the user ==
  171.  
  172. There may be situations where you would like to get user input while in 
  173. the middle of a stuffing.  For example you may create a file that on a 
  174. daily basis gathers data from one source and enters it into another 
  175. program and you would like the user to be able to input the date.  Since 
  176. the keyboard is still operative during stuffing, all you need do is put a 
  177. delay in the file (at the point where the program requests the date) that 
  178. lasts as long as it would ever take for the user to input the date. 
  179.  
  180. == Uninstalling KeyStuff ==
  181.  
  182. KeyStuff is a tiny TSR using only about 2.5K of RAM.  Once you run it, 
  183. this 2.5K portion of the program remains in memory until you re-boot or 
  184. uninstall it using the "/u" command line option.  In other words, to 
  185. uninstall KeyStuff enter
  186.  
  187. key /u
  188.  
  189. at the DOS prompt.  You MUST remove TSR's in the reverse order in which 
  190. they were loaded or you may lock up your computer, thus requiring a re-
  191. boot. 
  192.  
  193. == Help ==
  194.  
  195. If you forget any of the command line options, just enter "key /?" at the 
  196. DOS prompt and KeyStuff will provide you with a summary. 
  197.  
  198.                      
  199. == Special keys ==
  200.  
  201. You can also add special keys, like Escape, the function keys, the cursor 
  202. keys, (see table for complete list) into your data files by using a 
  203. special notation.  The process for inserting a special key is:
  204.  
  205. * Hold down the Alt Key
  206. * enter 232 on the numeric keypad
  207. * release the Alt key
  208. * enter the number of the special key as indicated in the following table
  209. * follow your input with a space
  210.  
  211. For example, entering 
  212.  
  213. Scott Φ70 Chaney
  214.  
  215. into your data file would tell KeyStuff to stuff "Scott ", then Shift-
  216. F10, and then "Chaney" into the keyboard buffer.  Φ is the value that 
  217. appears when you hold down the Alt key and enter 232.  70 is the number 
  218. associated with Shift-F10 as shown in the table below. 
  219.  
  220. == Special Character Table ==
  221.  
  222. To enter a special character: Enter Alt-232, enter the character # (as 
  223. derived from this table) and follow the input with a space.
  224.  
  225. Examples:  Alt-F3 = Φ43    Ctrl-PgDn = Φ34    Alt-J = Φ92    Esc = Φ53 
  226.     
  227.      Normal  Ctrl    Alt     Shift  │     Alt         Alt         Alt
  228. F1    1       21      41      61    │     1  71       A  83       N  96
  229. F2    2       22      42      62    │     2  72       B  84       O  97
  230. F3    3       23      43      63    │     3  73       C  85       P  98
  231. F4    4       24      44      64    │     4  74       D  86       Q  99
  232. F5    5       25      45      65    │     5  75       E  87       R 100
  233. F6    6       26      46      66    │     6  76       F  88       S 101
  234. F7    7       27      47      67    │     7  77       G  89       T 102
  235. F8    8       28      48      68    │     8  78       H  90       U 103
  236. F9    9       29      49      69    │     9  79       I  91       V 104
  237. F10   10      30      50      70    │     0  80       J  92       W 105
  238.                                     │     -  81       K  93       X 106
  239. Home  11      31                    │     =  82       L  94       Y 107
  240. End   12      32                    │                 M  95       Z 108
  241. PgUp  13      33
  242. PgDn  14      34
  243. RtArw 15      35
  244. LfArw 16      36
  245. UpArw 17      
  246. DnArw 18      
  247. Ins   19
  248. Del   20
  249. Tab   51                      60
  250. BS    52 ;also try non-special character:  (alt 8) 
  251. Esc   53 ;also try non-special character:  (Alt 27)
  252.  
  253.  
  254. == How KeyStuff interpets the data file ==
  255.  
  256. All characters are fed into the keyboard buffer except for linefeeds 
  257. (ascii 10) and the special notation characters ASCII 222 (▐) and ASCII 
  258. 232 (Φ).
  259.  
  260. Whenever KeyStuff encounters a carriage return (ASCII 13) it simulates 
  261. the Enter key being pressed.  Keep this in mind when you're creating your 
  262. data files.  The temptation is to add carriage returns just to keep the 
  263. format of the file looking "good" when you really don't want an Enter 
  264. sent to the computer. 
  265.  
  266. Make sure you edit your data files using an ASCII editor (like DOS 5's 
  267. EDIT program), or configure your editor to save in an ASCII format.  Many 
  268. editors insert special characters and/or compress the files when you save 
  269. them.  If you use such an editor to create or edit your data files 
  270. KeyStuff is not going to produce the results you want.  You can tell if 
  271. your editor is saving in a pure ASCII format by entering "type ????" at 
  272. the DOS prompt where ???? is the name of the file.  If the file looks as 
  273. it did when you created it then you're okay.  If it looks different than 
  274. when you use the editor then you need to find an ASCII editor or check to 
  275. see if you can configure your editor to save in an ASCII format. 
  276.  
  277. == Troubleshooting ==
  278.  
  279. *  "I set up KeyStuff to stuff a data file at some later time.  I then 
  280. used KeyStuff to stuff another data file now.  The delayed stuffing never 
  281. occured.  Why?"   
  282.  
  283. KeyStuff only acts on the last command line input.  All previous commands 
  284. are overwritten even if the stuffing hasn't occurred yet. 
  285.  
  286. *  "I used your table to input a special key, but the host program never 
  287. reacted to it?" 
  288.  
  289. Programs check for keys in a variety of ways.  A few go directly to the 
  290. keyboard and monitor each key as it is pressed and released.  Most 
  291. however use BIOS calls or directly check the keyboard buffer where the 
  292. BIOS service leaves the keystroke information.  KeyStuff won't work on 
  293. the former method but works great on the later method.  Most of the time. 
  294.  
  295. Some programs when looking for special keys check a special byte to see 
  296. what the shift state is at the time the key was pressed.  The shift state 
  297. byte tells if Ctrl, Alt, and the Shift Keys are being pressed.  If the 
  298. shift state indicates Ctrl, Alt, or Shift is being pressed then they 
  299. check the keyboard buffer to see what key was pressed in conjunction.  
  300. For example, they would check for Alt-D by checking the shift state byte 
  301. for the Alt key being pressed and then checking the keyboard buffer to 
  302. see if the D key is being pressed.  
  303.  
  304. On the other hand, the BIOS converts many special keys to special codes 
  305. that it puts in the keyboard buffer.  Programs that use this method would 
  306. ignore the shift state byte and just check for the special codes in the 
  307. keyboard buffer.  These are the keys that appear in our special key 
  308. table.  Because KeyStuff doesn't alter the shift state byte, it won't 
  309. work with the former method but will with the later. 
  310.  
  311. *  "Sometimes when I abort a stuffing by pressing both shift keys at once 
  312. a strange character appears."  
  313.  
  314. The host program is checking the shift state byte as described earlier.  
  315. It notices that you've pressed the shift keys and changes the 
  316. interpretation of the last key. 
  317.  
  318. == Technical Support ==
  319.  
  320. Registered users can call (206) 939-4105 for technical support or contact 
  321. us on CIS: 72371,1557
  322.  
  323. == Thanks ==
  324.  
  325. Thank you for your time.  I hope you find KeyStuff worthy of your 
  326. support.
  327.  
  328. == Legal ==
  329.  
  330. KeyStuff is copyrighted 1991 by RSE Inc.
  331.  
  332. RSE Inc. specifically disclaims all warranties pertaining to this 
  333. software.  The software is released "as is". 
  334.  
  335.